home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Ham Radio 2000
/
Ham Radio 2000.iso
/
ham2000
/
bbs
/
aut7p130
/
auto7pit.doc
< prev
next >
Wrap
Text File
|
1993-03-22
|
28KB
|
822 lines
1
AUTO7P v1.30
FBB server compatibile con 7plus 2.02 (1.63)
Invio e/o estrazione, ricezione e correzione automatica
di file in formato 7plus
by IK1GKJ@IW1BRX.ITA.EU.
7PLUS routine (c) DG1BBQ@DB0CL
IL SERVER NON E' COMPATIBILE CON 7PSERV DI SM0NCS.
--------------------------------------------------
AGGIORNAMENTI
-------------
Versione 1.0 beta test con nome 7PSERV
Versione 1.10
Dai bollettini in corcolazione, ho notato che SM0NCS si e'
molto arrabbiato per il fatto che ho chiamato questo server con lo
stesso nome del suo. Ho quindi cambiato il nome, onde evitare
ulteriori complicazioni. Credo che cosi' non debba aver piu' nulla
da dire. Tengo a precisare che il nome identico della precedente
versione non era per usurpare i diritti di SM0NCS, ma solo per non
creare confusione tra gli utenti dei vari bbs o sysop che erano
abituati a chiamarlo in quel modo.
Inserito possibilita' di redirigere l'outup anche per i file
.cor creati in seguito ad un file .ERR. (solo sysop)
Inserito possibilita' di richiedere una specifica parte di un
file, o di un .cor, nel caso cio' sia preferibile ad un file
intero.
Inserito possibilita' di dividere il file mail.in in piu'
parti, in modo da non intasare il forward, in blocchi di
dimensioni a piacere.
Per la sopradetta possibilita' lo stesso server puo' essere
lanciato nel cron.sys e provvedere alla ricomposizione del mail.in
AUTO7P v1.30 2
Lo stesso server, inserito nel cron.sys, provvede ad estrarre
da un file di forward su disco, tutti i bollettini 7+, ricomporli
ed eventualmente richiedere la correzione di errore.
Inserito blocco su richiesta invio file da parte degli utenti,
questi per sfruttare questa possibilita' devono essere abilitati
dal sysop.
Eliminato necessita' di specificare il bbs di ritorno, tale
path viene letto direttamente dal messaggio.
Versione 1.20
Velocizzato routine di estrazione 7plus da file di forward,
ora e' circa 3 volte piu' veloce.
Corretto routine di ricerca percorso di ritorno, ora accetta
anche alcuni formati non proprio standard.
Aggiunto variabile 7PMANAGER, e' possibile specificare il
nominativo a cui il server invia i messaggi sysop.
Creato programma M_FILTER.EXE, specifico per estrarre i 7plus,
come alternativa al file di forward, cio' velocizza ulteriormente
le operazioni del bbs.
Versione 1.21
Se l'utente inviava nel titolo del messaggio oltre al nome del
file qualche cosa contenente un '.', il nome del file non veniva
decodificato correttamente. Ok.
Se un bollettino 7plus arrivava troncato, all'atto della
ricostruzione si otteneva un messaggio write error sul metafile,
ed il metafile era cancellato. Ora il metafile non viene piu'
cancellato, e anche se difficilmente si riuscira' ad ottenere una
conversione, viene inviata ugualmente una richiesta di correzione.
Versione 1.22
A causa di un bug sfuggitomi, nelle precedenti versioni,
durante l'estrazione dei bollettini con l'opzione INQUIRYFILE, se
il nome del file nell'intestazione 7plus era lungo esattamente 12
caratteri, veniva perso il nome del mittente. Sistemato.
Versione 1.30
Per evitare incompatibilita' con versioni future di fbb, si e'
resa necessaria la creazione di un file di configurazione:
AUTO7P.CFG. E' stata aggiunta l'opzione DELETIME, per rimuovere
file piu' vecchi di un certo numero di giorni. E' stata aggiunta
AUTO7P v1.30 3
la possibilita' di settare una abilitazione di download globale,
solo come privato, per tutti gli utenti. Tal possibilita' e'
comunque subordinata a quanto settato in auto7p.cfg. E' stata
aggiunta la possibilita' di spostare i files convertiti in
apposita directory. Le variabili di enviroment 7PMANAGER e
7PMAXMAIL non sono piu' necessarie in quanto definite nel file fi
configurazione. Il programma non legge piu' ne' INIT.SRV, ne
INF.SYS, velocizzando quindi l'esecuzione.
INSTALLAZIONE
=============
Copiare AUTO7P.EXE nella directory di FBB ove si trova
INIT.SRV. Quindi alla fine di INIT.SRV, tra le due righe
tratteggiate, aggiungere:
---------------------------------
AUTO7P AUTO7P Codifica/decodifica file formato 7+
---------------------------------
POSSIBILITA' DEL SERVER
-----------------------
Invio di file agli utenti del bbs splittati se necessario per
una lunghezza di circa 6k.
* Invio automatico di correzione quando perviene un file di ERR.
* Invio automatico di files.ERR nel caso durante la compilazione
venga riconosciuto un errore.
* Durante la compilazione, o alla ricezione di un file di
correzione, se tutto e' ok il server provvede ad eliminare i file
superflui, e lasciare l'originale. In caso di un nuovo errore
provvede ad inviare la richiesta di correzione.
* Se lo scambio di dati avviene tra due bbs che utilizzano lo
stesso server, il tutto avviene in maniera automatica senza
intervento alcuno del sysop.
AUTO7P v1.30 4
* Il server provvede ad inviare messaggi di avvertimento al
sysop qualora un file sia stato correttamente compilato, e quindi
sia disponibile per il prelievo, oppure se qualche grave errore
richiede un intervento manuale. Cosi' come provvede ad avvertire
il mittente se nel messaggio/file inviato vi era un qualche cosa
di incorretto.
* Tutti i files vengono depositati in una directory chiamata
AUTO7P posta nella root del disco di lavoro. In questo modo solo
il sysop puo' accedere e manipolare i files in essa contenuti.
* Nel caso di un file correttamente convertito, e' possibile il
suo spostamento nella directory specificata in auto7p.cfg
* Possibilita' di redirezione dell'output, ossia e' possibile
inviare file splittati come SB/SP a qualsiasi destinatario @ bbs,
opzione riservata solo ai nominativi abilitati in auto7p.cfg e
limitata al solo invio di files e .cor
(Non avrebbe molto senso inviare un SB ---.ERR a IBM@ITA....).
* Possibilita' di richiere una singola parte di un file o di un
.cor nel caso questo questo sia preferibile all'intero file di
correzione, o nel caso di file di correzione multipli, uno solo di
essi vada perso.
* Possibilita' di redirigere un messaggio al server con il
comando SC (send copy) di FBB. (abilitazione in auto7p.cfg)
* Possibilita' di split del file mail.in in parti di dimensioni
a piacere, lo stesso server e' utilizzato per la ricomposizione.
* Inserito nel cron.sys, provvede ad estrarre da un eventuale
file di forward su disco tutti i 7+ pervenuti, ricomporli ed
eventualmente richiedere la correzione di errore.
* All'utente viene inibita la possibilita' di richiedere file, a
meno che non venga abilitato dal sysop, sempre in auto7p.cfg.
* La suddetta possibilita' puo' essere settata come globale,
affinche' tutti possano richiedere files, (non redirigere), in
questo caso un utente puo' essere escluso.
* Il server puo' cancellare i files presenti in \AUTO7P che
hanno una data anteriore a quanto specificato, questo per evitare
spreco di spazio disco.
AUTO7P v1.30 5
* Il server, nel caso un utente tenti un download fi file senza
averne l'autorizzazione, avvisa il sysop dell'accaduto, e provvede
ad inviare un messaggio all'utente pregandolo di contattare il
sysop per l'abilitazione.
* Ancora il server ritorna un codice di errore a FBB (che
provvedera' ad informare il sysop dell'accaduto con un bollettino
personale), in uno dei seguenti casi:
+ Errore nell'apertura o scrittura di MAIL.IN
+ Manca memoria per l'esecuzione.
+ Il server non e' stato chiamato nella maniera corretta.
+ Impossibile aprire o leggere il file argomento, o tale file
non e' nel formato riconosciuto dal server.
+ Impossibile leggere AUTO7P.CFG
+ Impossibile accedere alla directory \AUTO7P.
+ Impossibile accedere, se specificato, alla directory di
spostamento files convertiti.
Questi ultimi due errori sono abbastanza improbabili, visto
che se mancano, il server la crea automaticamente, ma non si sa
mai...
AUTO7P v1.30 6
IL FILE DI CONFIGURAZIONE AUTO7P.CFG
====================================
In questo file e' specificato tutto quanto e' necessario al
server per il funzionamento. Tale file e' cosi' composto:
Ogni riga che inizia con '#' e' considerata commento, e viene
ignorata dal programma. Le prime sette righe valide, sono
obbligatorie, e costituiscono le variabili del programma, le altre
sono opzionali.
Un cenno ai parametri:
Il parametro 1, nominativo del BBS, non e' che sia molto da
dire, tranne che l'ssid non va posto, se ad esempio il bbs e'
IW1BRX-8, ponete IW1BRX
Il parametro 2, directory base di lavoro del server, quando
richiedete lo split di un programma per l'immisione in rete,
questa e' la directory base. Non dimenticate il carattere '\'
finale. Normalmente \FBB\USERS\YAPP\
Il parametro 3, directory e nome del file di import del bbs,
deve essere uguale a quanto specificato in INIT.SRV come file
MAIL.IN.
Il parametro 4, directory dove porre i files correttamente
convertiti. Anche qui' non dimenticate il carattere '\' finale. Se
desiderate che i files convertiti non vengano spostati, ma restino
nella directory di lavoro di auto7p, ponete \AUTO7P\
Il parametro 5, redirezione messaggi del server, ed ex
variabile di enviroment 7PMANAGER: e' possibile che la gestione
software del bbs sia delegata ad un nominativo diverso da quello
del sysop. Questa opzione permette quindi di specificare il
nominativo cui devono essere inviati i messaggi del server, tipo
corrections successfull etc.
Il parametro 6, lunghezza massima del file mail.in, ed ex
parametro 7PMAXAIL. Tale variabile, se specificata indica al
server di limitare la dimensione creata del mail.in allo
specificato numero di Kilobytes. I bollettini seguenti saranno
inseriti in file temporanei e ricomposti a tempo dallo stesso
server. I valori accettati, espressi in KBytes, vanno da 20 a
1000. Ponendo 0 o settando un valore fuori range, il server
appende l'intero contenuto al mail.in, quindi non verranno mai
creati file temporanei e tutto sara' subito inserito nel forward.
Ho testato il tutto inserendo in forward un file mail.in di 800K,
e non ci sono stati problemi dal punto di vista software.
AUTO7P v1.30 7
Non e' una buona idea quella di inserire tutto in forward in
un solo blocco, si richierebbe un intasamento nella rete. 50 e' un
valore ottimale.
Il parametro 7, abilitazione globale per il download dei
programmi. Settando questo campo a 0, gli unici utenti abilitati a
fare download di programmi, saranno quelli specificati con flag=1
nel file auto7p.cfg. Specificando come campo 1, tutti saranno
abilitati a fare download, tranne quelli settati con flag a 0.
Tengo a precisare che come download si intende un download verso
il proprio nominativo, in quanto per la redirezione (SB IBM@ITA
per esempio), occorre un ulteriore abilitazione.
Le successive righe nel file di configurazione, da 0 a N,
saranno del tipo NOMINATIVO FLAG, ove il nominativo e' senza SSID,
e il campo flag puo' assumere il seguente significato:
0 puo' fare upload
1 puo' fare download
2 accede a tutte le possibilita' del server
Ad esempio:
IK1GKJ 2
IK1MSL 1
IK1XXX 0
Se il parametro 7 e' posto a 0, allora solo IK1MSL potra' fare
download di files, e solo verso se stesso. Tutti gli altri,
potranno solo fare upload. Eccezione IK1GKJ che essendo settato a
2 potra' fare cio' che vuole.
Se il parametro 7 e' posto a 1, tutti potranno richiedere download
in 7plus per se stessi, tranne IK1XXX che risulta abilitato al
solo upload. Ancora nessuna limitazione per IK1GKJ.
Ecco un esempio di AUTO7P.CFG
# Nominativo del BBS
IK1GKJ
#
# Directory base per download
C:\FBB\USERS\YAPP\
#
# Percorso e nome del file di import del BBS
C:\FBB\MAIL.IN
#
# Directory dove porre i files convertiti
C:\FBB\USERS\YAPP\7PLUS\
AUTO7P v1.30 8
#
# Nominativo cui indirizzare i messaggi di auto7p
IK1GKJ
#
# Lunghezza massima del file mail.in (KBytes)
50
#
# Abilitazione globale per il download
0
#
# Lista nominativi con autorizzazioni particolari
IK1GKJ 2
IK1MSL 2
IW1BRX 1
#
# Fine dell'esempio
AUTO7P v1.30 9
LE PAROLE CHIAVE
================
AUTO7P TO SB/SP [DESTINATARIO] @ [[BBS]]
---------
Applicazione: invio files dati e files .cor
Abilitazione: users flag=2
La parola chiave AUTO7P TO inserita nel messaggio consente di
forzare il tipo di messaggio, il destinatario e il bbs di arrivo
nella richiesta di invio files. I parametri tra [] sono opzionali,
ma devono essere inseriti in sequenza. Normalmente AUTO7P utilizza
il tipo SP per i messaggio, ma con SB e' possibile farli diventare
bollettini pubblici.
Le redirezioni tra [] sono opzionali, ma devono essere
inserite in sequenza. Non e' possibile specificare solo il
destinatario ed omettere il tipo di bollettino. Le possibili
variazione sono:
AUTO7P TO SB
AUTO7P TO SB DESTINATARIO
AUTO7P TO SP DESTINATARIO @ BBS
AUTO7P PART x x>=1 e x<=255
-----------
Applicazione: files di dati e files .err
Abilitazione: dati users flag=1, richieste correzione tutti.
Questa possibilita' permette di richiedere solo una singola
parte di un files. Se ad esempio all'atto della conversione noto
che una intera parte dei file e' arrivata corrotta, posso
richiedere l'invio di quella singola parte anziche' il file di
correzione, che potrebbe risultare piu' lungo. Ancora, se in
seguito ad una richiesta di correzione, mi vengono inviati 3 files
di correzione, ed il numero 2 mi torna danneggiato, posso
nuovamente richiederlo inviando il file.err originariamente creato
e richiedere solo la relativa parte 2 della correzione.
Le opzioni AUTO7P TO e AUTO7P PART sono naturalmente sommabili,
ossia possono essere inserite entrambe a seconda delle esigenze.
AUTO7P v1.30 10
AUTO7PCLOCK
-----------
Se avete specificato una dimensione di split del file mail.in,
parametro 6 in auto7p.cfg, dovete OBBLIGATORIAMENTE inserire nel
cron.sys il comando a tempo per ricomporre i file temporanei
creati dal server, che altrimenti non verranno mai inseriti in
FBB. Inserite quindi nel file CRON.SYS la seguente riga:
X AUTO7P AUTO7PCLOCK
INQUIRYFILE filename
--------------------
Questo comando indica al server di estrarre tutti i bollettini
7+ da un eventuale file di forward su disco, ricomporli e in caso
di errore richiedere al mittente la correzione. Per ottenere
questo sono necessari pochi e semplici interventi sui files di
FBB:
In BBS.SYS, inserire in corrispondenza di una riga vuota, a destra
dei numeri di riga AUTO7P, segue l'esempio:
prima dopo
01 IK1MSL 01 IK1MSL
02 IW1BRX 02 IW1BRX
03 03 AUTO7P
04 04
05 05
In FORWARD.SYS, creare un blocco di forward, l'esempio seguente
assume che vogliate inviare su disco tutti i privati, e i
bollettini che siano indirizzati a SYSOP.
La linea ! B IK1GKJ e' inserita per evitare che eventuali file
inviati a AUTO7P@IK1GKJ vengano inseriti creando dei doppioni.
#
A AUTO7P
P @
! B IK1GKJ
B AUTO7P
F SYSOP
G *
C D:\FBB\AUTO7P.FWD
------------
AUTO7P v1.30 11
Come da esempio riportato, si assume che questo file di forward
sia inserito in D:\FBB\AUTO7P.FWD, quindi in CRON.SYS aggiungo:
X AUTO7P INQUIRYFILE D:\FBB\AUTO7P.FWD
Questo e' tutto, ancora il server pensera' ad avvertire il sysop
quandi il 7plus sara' completato e a richiedere evenutali
correzioni. Le opzioni INQUIRYFILE e AUTO7PCLOCK possono essere
inserite entrambe.
******************************************************************
LEGGERE LA DOCUMENTAZIONE A PROPOSITO DI M_FILTER.EXE PER UNA
FORMA ALTERNATIVA E PIU' EFFICIENTE DEL FORWARD SU DISCO
******************************************************************
L'estrazione dei file di forward avviene secondo le seguenti
regole:
Il messaggio non deve essere una copia, ossia un CP, questo
per evitare di inserire un doppione.
Vengono estratti solo ed unicamente i 7plus, non le correzioni
o files di errore; questi ultimi perche non necessari, le
correzioni perche' non e' detto che riguardino i bollettini da noi
ricevuti. Quindi si tenta la ricomposizione, e se un errore viene
generato, questo viene automaticamente inviato al mittente del
bollettino, con la preghiera di tornare la correzione a AUTO7P.
Se un file e' gia presente, come 7PL o Pxx, o se gia presente
come file ricostruito, i bollettini che lo rigardano non vengono
estratti, cosi' da non avere doppioni.
Una volta avvenuta la ricomposizione, i files non necessari
vengono cancellati, a il sysop viene avvertito della presenza del
nuovo file.
AUTO7P v1.30 12
DELETIME day
------------
Questa opzione serve ad eliminare dalla directory di lavoro di
auto7p, \AUTO7P\, tutti quei files che hanno una data precedente a
quanto specificato. La cosa risulta utile per quei files di cui
per questo o quest'altro motivo non avete ricevuto tutte le parti,
oppure per quei files corrotti di cui non avete mai ricevuto la
correzione. Tutti questi dati occupano spazio su disco, quindi
passato un periodo di tempo che ritenete ragionevole, potreste
volerli cancellare. Allo scopo e' aggiungete al vostro appel.bat,
giusto prima o dopo il comando epurmess, la seguente riga:
AUTO7P DELETIME X
dove X rappresenta il numero di giorni di epurazione. Se ad
esempio ponete AUTO7P DELETIME 25, allora il server eliminera'
tutti quei files piu' vecchi di 25 giorni rispetto alla data
attuale. Fate attenzione all'uso di questa opzione, un valore
troppo basso potrebbe impedire la ricostruzione di quanto gia' in
vostro possesso, dato che l'invio di una correzione o di tutte le
parti del file potrebbe richedere un certo tempo. Un giusto valore
si aggira tra 20 e 40.
COMANDO SC DI FBB
-----------------
Il server e' in grado di strippare l'intestazione di copia
dall'header del messaggio, e di ricostruire il mittete originale.
Questa opzione, riseRvata per i soli USER FLAG=2, si revela utile
quando ad esempio un utente invia una richiesta di correzione o un
file di errore, e invece di inviarla al server, la invia al
titolare del BBS, succede piu' spesso di quanto si crede.
Il suo utilizzo e' molto semplice:
SC #msg AUTO7P
Anche questa opzione puo' essere sommata alle altre, quindi ad
esempio e' possibile la redirezione dell'output. (Puo' servire ?).
AUTO7P v1.30 13
COME SI USA IL SERVER
---------------------
Le parti tra parentesi [] sono opzionali.
Notare che la directory di partenza del server e' sempre quella
specificata nel file AUTO7P.CFG. Tale directory non deve essere
specificata nel percorso file, in quanto automaticamente aggiunta
dal server. Se necessario, devono essere incluse solo le
sottodirectory seguenti.
Utente o altro FBB che richiede un files
----------------------------------------
Abilitazione: variabile download globale a 1 e user flag<>0,
oppure variabile download globale a 0 e user flag=1 o 2
Se le condizioni di abilitazione non sono valide, viene inviata
copia della richiesta al sysop, che potra' provvedere al settaggio
del nominativo in AUTO7P.CFG, mentre all'utente viene inviato un
messaggio in cui si richiede di contattare il sysop per
l'eventuale abilitazione.
SP AUTO7P [@ BBS]
UTILITY\TEST.EXE
[AUTO7P TO ..... ] (abilitazione users flag=2)
[AUTO7P PART ...]
/EX
Utente o altro FBB che richiede una correzione
----------------------------------------------
Abilitazione: tutti
SP AUTO7P [@ BBS]
UTILITY\TEST.ERR
[AUTO7P PART ...]
[AUTO7P TO .....] (abilitazione users flag=2)
......
CONTENUTO DEL FILE .ERR GENERATO DA 7PLUS O ALTRO SERVER
......
/EX
Qui' la specifica parte di correzione puo' tornare utile nel caso
vengano inviate piu' parti di correzione, ed una di esse andasse
persa.
AUTO7P v1.30 14
Utente che invia una correzione
-------------------------------
Abilitazione: tutti
SP AUTO7P [@ BBS]
UTILITY\TEST.COR (o C01, C02....)
......
CONTENUTO DEL FILE DI CORREZIONE GENERATO DA 7PLUS O
ALTRO SERVER
......
/EX
Utente che desidera inviare un file
-----------------------------------
Abilitazione: tutti
SP AUTO7P [@ BBS]
UTILITY\TEST.7PL
......
CONTENUTO DEL FILE
......
/EX
oppure
SP AUTO7P [@ BBS]
UTILITY\TEST.Pxx
......
CONTENUTO DELLA PARTE xx
......
/EX
Avrete notato che ho sempre specificato il percorso di un file
nel titolo del messaggio. Questo e' importante per un corretto
funzionamente del server, infatti nel caso sia necessario inviare
correzioni a errori e per un funzionamento automatico del server,
e' necessario che AUTO7P sappia dove cercare i files.
Il percorso parte sempre in ogni caso dalla directory che il bbs
ha specificato come base in AUTO7P.CFG, parametro 2, quindi voi
dovrete segnalare solo il percorso seguente.
Se le varie richieste vengono fatte tra bbs diversi che utilizzano
entrambi questo server, lo scambio di informazionei avviene in
modo del tutto automatico, e il nominativo di ritorno viene
sostituito da AUTO7P@BBS_DI_RITORNO.
AUTO7P v1.30 15
Segnalazioni di errori, o eventuali suggerimenti saranno molto
graditi.
Cordiali 73, Mario IK1GKJ @ IW1BRX
AGGIORNAMENTI ....................................................1
INSTALLAZIONE ....................................................3
POSSIBILITA' DEL SERVER ..........................................3
IL FILE DI CONFIGURAZIONE AUTO7P.CFG .............................6
LE PAROLE CHIAVE .................................................9
AUTO7P TO SB/SP [DESTINATARIO] @ [[BBS]] .....................9
AUTO7P PART x x>=1 e x<=255 ............................9
AUTO7PCLOCK .................................................10
INQUIRYFILE filename ........................................10
DELETIME day ................................................12
COMANDO SC DI FBB ...........................................12
COME SI USA IL SERVER ...........................................13
Utente o altro FBB che richiede un files ....................13
Utente o altro FBB che richiede una correzione ..............13
Utente che invia una correzione .............................14
Utente che desidera inviare un file .........................14